Skip to content

Document MySQL 8.4.x minimum and how to upgrade MySQL in Self-Managed deployments#2653

Merged
mdlinville merged 15 commits into
mainfrom
DOCS-2658
Jun 15, 2026
Merged

Document MySQL 8.4.x minimum and how to upgrade MySQL in Self-Managed deployments#2653
mdlinville merged 15 commits into
mainfrom
DOCS-2658

Conversation

@mdlinville

@mdlinville mdlinville commented May 20, 2026

Copy link
Copy Markdown
Contributor

Description

Document MySQL 8.4.x minimum and how to upgrade MySQL in Self-Managed deployments

  • Add a section with instructions, including giving links for figuring out the correct Aurora version. Unfortunately it doesn't look like there is an Aurora version yet that is compatible with 8.4.x, according to Aurura docs.
  • Add a note to a few pages
  • Intentionally does not give detailed instructions about upgrading MySQL itself

Fixes DOCS-2658

Testing

  • Local build succeeds without errors (mint dev)
  • Local link check succeeds without errors (mint broken-links)
  • PR tests succeed

@mdlinville mdlinville requested a review from a team as a code owner May 20, 2026 23:43
@mintlify

mintlify Bot commented May 20, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
wandb 🟢 Ready View Preview May 20, 2026, 11:51 PM

@github-actions

github-actions Bot commented May 20, 2026

Copy link
Copy Markdown
Contributor

📚 Mintlify Preview Links

🔗 View Full Preview

✨ Added (1 total)

📄 Pages (1)

File Preview
snippets/_includes/self-managed-mysql-eol-upgrade.mdx Self Managed Mysql Eol Upgrade

📝 Changed (5 total)

📄 Pages (5)

File Preview
platform/hosting/hosting-options/self-managed.mdx Self Managed
platform/hosting/self-managed/operator.mdx Operator
platform/hosting/self-managed/ref-arch.mdx Ref Arch
platform/hosting/self-managed/requirements.mdx Requirements
snippets/_includes/self-managed-version-requirements.mdx Self Managed Version Requirements

🤖 Generated automatically when Mintlify deployment succeeds
📍 Deployment: dc5e9de at 2026-06-15 17:47:20 UTC

@github-actions

github-actions Bot commented May 20, 2026

Copy link
Copy Markdown
Contributor

🔗 Link Checker Results

All links are valid!

No broken links were detected.

Checked against: https://wb-21fd5541-docs-2658.mintlify.app

Comment thread platform/hosting/self-managed/operator.mdx Outdated
Comment thread snippets/_includes/self-managed-mysql-eol-upgrade.mdx Outdated
Comment thread snippets/_includes/self-managed-version-requirements.mdx Outdated
Co-authored-by: Matt Linville <matt@linville.me>
- You don't need to drain W&B or shut it down
- W&B will be temporarily unavailable until MySQL comes back
- Adjusted verification steps a bit
Copilot AI review requested due to automatic review settings June 11, 2026 05:03

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Documents the new MySQL baseline for W&B Self-Managed deployments (moving from MySQL 8.0.x to MySQL 8.4.x), adds an end-of-life notice for MySQL 8.0.x, and provides a high-level (W&B-sequence-focused) upgrade guide in the Operator docs.

Changes:

  • Update Self-Managed version requirements to recommend/require MySQL 8.4.x and add Aurora versioning guidance.
  • Add a reusable “MySQL 8.0 EOL / upgrade to 8.4.x” callout snippet and surface it across key Self-Managed pages.
  • Add an “Upgrade MySQL to 8.4.x” section to the Operator guide and update Self-Managed infra requirements wording.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
snippets/_includes/self-managed-version-requirements.mdx Updates the MySQL entry in the Self-Managed “minimum versions” table and adds Aurora versioning guidance.
snippets/_includes/self-managed-mysql-eol-upgrade.mdx Introduces a reusable Important callout noting MySQL 8.0.x EOL and linking to the upgrade steps.
platform/hosting/self-managed/requirements.mdx Imports and renders the new MySQL EOL/upgrade callout in the requirements page.
platform/hosting/self-managed/ref-arch.mdx Imports and renders the new MySQL EOL/upgrade callout in the reference architecture page.
platform/hosting/self-managed/operator.mdx Adds the MySQL EOL/upgrade callout near MySQL requirements and introduces a new “Upgrade MySQL to 8.4.x” section.
platform/hosting/hosting-options/self-managed.mdx Updates the “Required infrastructure” list item to “MySQL 8.4.x database”.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread platform/hosting/self-managed/operator.mdx Outdated
Comment thread snippets/_includes/self-managed-version-requirements.mdx Outdated
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 6 out of 6 changed files in this pull request and generated 3 comments.

Comment thread snippets/_includes/self-managed-version-requirements.mdx Outdated
Comment thread snippets/_includes/self-managed-mysql-eol-upgrade.mdx Outdated
Comment thread platform/hosting/self-managed/operator.mdx Outdated
mdlinville and others added 2 commits June 11, 2026 14:35
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
@mdlinville

Copy link
Copy Markdown
Contributor Author

This change really needs to go out and is in alignment with internal discussions, so I'll merge it and we can iron out any wrinkles that arise.

@mdlinville mdlinville merged commit 1ae870d into main Jun 15, 2026
8 of 9 checks passed
@mdlinville mdlinville deleted the DOCS-2658 branch June 15, 2026 17:52
ngrayluna pushed a commit that referenced this pull request Jun 15, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants